Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* 📝 Add docstrings to `modernize`

Docstrings generation was requested by @JarbasAl.

* #45 (comment)

The following files were modified:

* `ovos_stt_http_server/__init__.py`
* `ovos_stt_http_server/gradio_app.py`

* Update gradio_app.py

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: JarbasAI <33701864+JarbasAl@users.noreply.github.com>

…add docs

- Remove Gradio support entirely (gradio_app.py deleted, has_gradio param removed)
- CORSMiddleware now always allow_origins=["*"] (no env var)
- Remove gradio and flask from pyproject.toml dependencies
- Remove --gradio, --cache, --title, --description, --info, --badge CLI args
- Update unit_tests.yml from obsolete neongeckocom ref to OpenVoiceOS/gh-automations@dev
- Add lint.yml, build_tests.yml, pip_audit.yml workflows
- Add docs/index.md, QUICK_FACTS.md, FAQ.md, MAINTENANCE_REPORT.md, AUDIT.md, SUGGESTIONS.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Adds OpenAI Whisper, Deepgram, Google Cloud STT, AssemblyAI, and
Speechmatics-compatible endpoints so any 3rd-party app can use OVOS
STT plugins as a drop-in replacement.

- New ovos_stt_http_server/audio_utils.py: multipart_audio_to_audiodata()
  supporting WAV via stdlib and other formats via pydub
- New routers/: openai_whisper, deepgram, google_stt, assemblyai,
  speechmatics — all via make_X_router(model) factory pattern
- All schemas use Pydantic Field() constraints with Literal types
- AssemblyAI/Speechmatics are synchronous stubs (base64 audio inline)
- test/unittests/test_compat_routers.py: 20 tests, all passing

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Each compat router now mounts under a prefix that identifies the API vendor:
  /openai/v1/...             OpenAI Whisper
  /deepgram/v1/...           Deepgram
  /google/v1/...             Google Cloud STT
  /assemblyai/v2/...         AssemblyAI
  /speechmatics/v1/...       Speechmatics

Benefits: all routers coexist with no path conflicts; Swagger groups by vendor.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

New tests: Whisper text/verbose_json formats, translations lang forcing,
Deepgram punctuate param, Google STT base64 WAV, AssemblyAI status field,
Speechmatics 404 for unknown id, Speechmatics full POST→GET flow.

AI-Generated Change:
- Model: claude-sonnet-4-6
- Intent: validate response formats, job flow, and param handling
- Impact: 17 → 25 tests
- Verified via: uv run pytest test/ -v (25 passed)